home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / faxmodem.Z / faxmodem
Text File  |  2002-07-08  |  6KB  |  130 lines
  1. FAXMODEM(${MANNUM1_8})               FAXMODEM(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        faxmodem     -  dynamically     add  a    modem to a _H_y_l_a_F_A_X server
  7.        system
  8.  
  9. SSYYNNOOPPSSIISS
  10.        $${{SSBBIINN}}//ffaaxxmmooddeemm    [ --qq _q_u_e_u_e_-_d_i_r ] [ --cc _c_a_p_a_b_i_l_i_t_i_e_s ] [ --pp
  11.        ] [ --PP ]    [ --uu _p_r_i_o_r_i_t_y ]    _m_o_d_e_m
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _f_a_x_m_o_d_e_m     sends    a  message  to the _H_y_l_a_F_A_X queuer process
  15.        _f_a_x_q(${MANNUM1_8}) telling it that the specified    modem  is
  16.        ready for use and informing it about its    fax-related capa
  17.        bilities.  This is the mechanism    by which modems    are added
  18.        in  a send-only configuration.  Once a modem has    been con
  19.        figured its status can be  reconfigured    using  the  _f_a_x_s_
  20.        _t_a_t_e(${MANNUM1_8})  program.  _f_a_x_m_o_d_e_m can also be used to
  21.        alter the capabilities and usage    priority of a  previously
  22.        configured modem.
  23.  
  24.        The  specified  _m_o_d_e_m  is  either the terminal device name
  25.        where the modem is attached or a    _H_y_l_a_F_A_X    device identifier
  26.        (see   _h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MANNUM4_5})   for  information  on
  27.        device identifiers).  Device names may be given without    a
  28.        leading     directory   pathname;     e.g.  ttyf2  instead  of
  29.        /dev/ttyf2.
  30.  
  31.        To figure out the capabilities of a modem either     use  the
  32.        _p_r_o_b_e_m_o_d_e_m(${MANNUM1_8})     script     or  manually communicate
  33.        with the    modem.    For a Class 2 modem the    capabilities  are
  34.        given  in  the response to the ``AT+FDCC=?'' query command
  35.        and for a Class 2.0 modem the  ``AT+FCC=?''  command.   To
  36.        check  if  a modem is capable of    polled retrieval of docu
  37.        ments  use  ``AT+FSP=?''     for  a     Class     2.0   modem   or
  38.        ``AT+FSPL=?''  for  a Class 2 modem; if ``1'' is    indicated
  39.        in the response then  the  modem     supports  polling.   For
  40.        example,
  41.           hyla% ccuu --ll ttttyyff22
  42.           Connected
  43.           aatt++ffccllaassss==22..00
  44.           OK
  45.           aatt++ffcccc==??
  46.           (0,1),(0-5),(0-2),(0-2),0,0,0,(0-7)
  47.           OK
  48.           aatt++ffsspp==??
  49.           (0,1)
  50.           OK
  51.  
  52.        In this case the    modem would be added using the command:
  53.           ${SBIN}/faxmodem -c '(0,1),(0-5),(0-2),(0-2),0,0,0,(0-7)'    ttyf2
  54.  
  55.        (by default polling is assumed to be supported).
  56.  
  57.        Class  1     modems     require a different technique.     The host
  58.        implements most of the fax protocol so all that is  needed
  59.        is  to  identify     the  possible signalling rates    the modem
  60.        supports     for  transmitting;  this  is    done   with   the
  61.        ``AT+FTM=?'' command.  For example,
  62.           hyla% ccuu --ll ttttyyff22
  63.           Connected
  64.           aatt++ffccllaassss==11
  65.           OK
  66.           aatt++ffttmm==??
  67.           24,48,72,73,74,96,97,98,121,122,145,146
  68.           OK
  69.  
  70.        In  this     case  the modem supports 2400,    4800, 7200, 9600,
  71.        12200, and 14400    bps signalling rates so    the  modem  would
  72.        be added    using:
  73.           ${SBIN}/faxmodem -c '(0,1),(0-5),(0-2),(0-2),(0,1),0,0,(0-7)' ttyf2
  74.  
  75. OOPPTTIIOONNSS
  76.        The following options are available:
  77.  
  78.        --cc     Specify  the  fax  capabilities using the syntax
  79.          defined  by  the  ``Class   2''   specification:
  80.          ``(_v_r),(_b_r),(_w_d),(_l_n),(_d_f),(_e_c),(_b_f),(_s_t)''.
  81.          where,     _v_r  specifies    vertical  resolution,  _b_r
  82.          specifies  bit    rate, _w_d specifies page    width, _l_n
  83.          specifies page    length,    _d_f  specifies  data  com
  84.          pression,  _e_c    specifies  error  correction,  _b_f
  85.          specifies binary file transfer, and _s_t    specifies
  86.          scan time/line; and each of the above specifica
  87.          tions is a range or list of numbers that defines
  88.          the  exact capabilities of the    modem.    For exam
  89.          ple,     the     default     capabilities     are
  90.          ``(0,1),(0-3),(0-4),(0-2),(0),(0),(0),(0-7)''
  91.          which specifies the modem is capable of  sending
  92.          and  receiving    both low and high resolution fac
  93.          simile    with a variety of  page     sizes;     supports
  94.          signalling  rates  0-3     (2400    bps  through 9600
  95.          bps); supports    only 1D-encoded    data compression;
  96.          and  does not support error correction    or binary
  97.          file transfer.     A  modem's  ability  to  support
  98.          polled    retrieval of facsimile is specified sepa
  99.          rately    with the --pp and    --PP options.
  100.  
  101.        --pp     Specify the modem is nnoott capable of polling  for
  102.          remote    documents.
  103.  
  104.        --PP     Specify  the  modem  is  capable  of polling for
  105.          remote    documents (default).
  106.  
  107.        --qq _d_i_r     Use a spooling    area other than    _$_{_S_P_O_O_L_}.
  108.  
  109.        --uu _p_r_i_o_r_i_t_y
  110.          Assign    the specified priority to the modem  when
  111.          scheduling  it     for outbound use.  Modem priori
  112.          ties are numbers  in  the  range  [0..255]  with
  113.          lower    numbers     meaning higher    priority.  Modems
  114.          are initially assigned    priority 255.
  115.  
  116. FFIILLEESS
  117.        ${SPOOL}            default    spooling area
  118.        ${SPOOL}/FIFO        fifo for contacting _f_a_x_q
  119.  
  120.        Consult _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}) for    a  complete  dis
  121.        cussion of the structure    and content of the spooling area.
  122.  
  123. SSEEEE AALLSSOO
  124.        _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}),      _f_a_x_g_e_t_t_y(${MANNUM1_8}),
  125.        _f_a_x_q(${MANNUM1_8}).
  126.  
  127.  
  128.  
  129.                Oct 27, 1995       FAXMODEM(${MANNUM1_8})
  130.